Die SSI-PlugIns des Webservers

Der Datenzugriff erfolgt durch PlugIns die bei Aufruf einer Seite mit den entsprechenden Daten ersetzt werden.
Damit der Webserver die PlugIns ausführt ist die Dateiendekennung ".ssi" oder ".xml" erforderlich.
Die Dateiendekennung ".htm" beschreibt eine Datei ohne PlugIns.
Die Abkürzung SSI steht für "Server Side Included".

PlugIn	Description	Parameter
READPI ADR=IW0&FORMAT=%d	Read Processdata from Device	ADR= address in IEC1131-Syntax FORMAT= Result in (d)ec or he(x)
WRITEPI ADR1=MW0&VALUE1=1234&FORMAT1=%d	Write Processdata to Device	ADR(i): address in IEC1131-Syntax VALUE(i): value, (i= Index 1..24) FORMAT(i): value in (d)ec or he(x)
GETTIMEDATE FORMAT=%d.%m.%y %H:%M:%S	Read Date and/or Time from Device	FORMAT= like printf in C
AUTHUSR USR1=jon&PWD1=doe&RT1=R	Protect custom HTML-pages	USR(i): username, PWD(i): password, RT(i): reserved (i= Index 1..5)

Die lesenden SSI's READPI und GETTIMEDATE

Die Plugins werden auf dem Server ausgeführt und durch den Rückgabewert ersetzt. Erst anschliessend wird die HTML-Seite an den Browser des Users übertragen. Im Gegensatz zur POST Methode, benötigen lesende SSI-PlugIns keine Eingaben vom User.
Alle lesenden PlugIns beginnen mit der Startsequence "" abgeschlossen.

Das schreibende SSI WRITEPI

WRITEPI erlaubt das Schreiben von max. 24 Datensätze pro Aufruf.
Ein Datensatz besteht aus den Parametern: ADR(i), VALUE(i) und FORMAT(i),
wobei i für den Index von 1 bis 24 steht. Nur vollständige Datenätze werden verarbeitet.
Uebertragen werden die Datensätze in einem Formular mit der Methode POST.
Als Formularaktion wird der Name des schreibenden Plugins "WRITEPI" verwendet.

Kodierung des Parameters ADR

IEC1131-address				Description
%				Start tag
	I			Physical input
	Q			Physical output
	M			Retain memory
		X		Bit
		B		Byte
		W		Word
		D		DWord
			x.y	Numeric address

Das Authentifizierungs SSI AUTHUSR

Für jede HTML-Seite lassen sich bis zu 5 Benutzer oder Benutzergruppen definieren.
Ein Benutzer bzw. Benutzergruppe wird durch die drei Parameter USR, PWD und RT sowie einen Index beschrieben.
- USR => Username (max 16 Chars - not case sensitive)
- PWD => Password (max 16 Chars - case sensitive)
- RT => reserved for further use

Das AUTHUSR-SSI ist wie alle PlugIns im "body"-Abschnitt der zu schützenden HTML-Seite zu plazieren.
Als Dateiendung wird ".ssi" erwartet, da der Webserver in ".htm"-Dateien keine SSI's vermutet.
Verwendet wird der "BasicAuthentication" Mechanismus.
Die Funktionalität steht ab der Firmwarerelease (07) zur Verfügung.

Funktion:
Bei der Anfrage einer ".ssi"-Datei durchsucht der Webserver den "body"-Abschnitt der HTML-Seite. Wird das "AUTHUSR"-SSI gefunden vergleicht der Webserver den aktuell angemeldeten Benutzer mit der Liste der autorisierten Benutzer. Mit angemeldetem Benutzer ist die letzte erfolgreich ausgeführte Passwordabfrage gemeint, da die Benutzer/Password-Information bei jeder Anfrage, bis zum beenden der Browser-Sitzung, zum Webserver übertragen werden.
Ist kein oder ein unberechtigter Benutzer angemeldet, wird als Antwort "401 Autorisation required" an den Browser gesendet, der daraufhin ein Password-Dialog anzeigt.
Nach Eingabe einer berechtigten Benutzer/Password-Kombination entfernt der WebServer den "SSI-Kommentar" aus der HTML-Seite und sendet diese an den Browser.
Ist das Password unbekannt läst sich der Password-Dialog über sie Abbrechen-Schaltfläche verlassen, anschliessend kann auf eine andere Seite gewechselt werden.